Skip to main content

Submit Master Location

Method: POST
/data-provider/locations

As a Data Provider in the iFoodDS partner program, you use the iFoodDS Master Location API to send FSMA 204 master location data on behalf of shared customers to the iFoodDS Trace Exchange platform. This streamlines the capture and sharing of customer’s FSMA 204 event data promoting efficiency for our shared customers.

Records will be stored for a minimum of two years.

info

This endpoint is being refined and thus subject to change. These docs will update when changes are made.

Request​

Type: application/json

The body of the request comprises one section: the locationMasterList.

{
    "locationMasterList": [
        {
            "dataProviderVendorId": "<data provider vendor id>",
            "dataProviderVendorName": "<data provider vendor name>",
            "locationName": "<location name>",
            "locationCode": "<location code>",
            "businessUnit": "<business unit>",
            "market": "<market>",
            "region": "<region>",
            "locationType": "<location type>",
            "parentLocationId": "<parent location id>",
            "gln": "<GLN (global location number)>",
            "glnAssignedBy": "<GLN assigned by>",
            "duns": "<DUNS number>",
            "alternateLocationCode": "<alternate location code>",
            "phoneNumber": "<phone number>",
            "isPrimaryLocation": true,
            "isCoveredByGdst": false,
            "address": {
                "streetAddress1": "<street address 1>",
                "streetAddress2": "<street address 2>",
                "city": "<city>",
                "state": "<state>",
                "postalCode": "<postal code>",
                "country": "<country code>"
            },
            "geoLocation": {
                "gpsCoordinates": [
                    "<latitude>",
                    "<longitude>"
                ],
                "geoFence": [
                    [
                        "<latitude1>",
                        "<longitude1>"
                    ],
                    [
                        "<latitude2>",
                        "<longitude2>"
                    ],
                    [
                        "<latitude3>",
                        "<longitude3>"
                    ]
                ]
            }
        }
    ],
}

Data Constraints​

Please note the following data constraints:

  • strings allow a maximum of 100 characters

Location Data​

Required​

  • dataProviderVendorId (string): Your ID for the vendor/supplier
  • locationName (string): Name of vendor's or purchaser's location referenced in the event
  • locationCode (string): Vendor's or purchaser's location code referenced in the event

If address and contact information is already set up in master data with locationCode, then the address information is not required. Otherwise, it is required. Provide at least one of the following:

  • gln (string): GS1 Global Location Number, a 13-digit string. GS1 GTIN Executive Summary
  • duns (string): Dun & Bradstreet Data Universal Numbering System number, a 9-digit string
  • address (object):
    • streetAddress1 (string): Physical street address line 1 information
    • streetAddress2 (string): Physical street address line 2 information, if applicable
    • city (string): City location
    • state (string): State or region location
    • postalCode (string): ZIP or postal code
    • country (string): Country location
    • geoLocation optional (object): Consisting of either...
      • gpsCoordinates as an array of strings representing the latitude followed by longitude expressed in degrees and minutes OR
      • geoFence as an array of string arrays representing the latitude followed by longitude expressed in degrees and minutes for each set of coordinates defining the geo fence

Optional​

  • businessUnit (string): Indicates the business unit associated with the location.
  • market (string): Indicates the market associated with the location.
  • region (string): Indicates the region assocaited with the location.
  • dataProviderVendorName (string): Name of the vendor/supplier
  • locationType (string): Indicates whether the location is "Internal", "Supplier", or "Customer"
  • parentLocationId (string): To create a hierarchy of locations (divisions, regions, etc.), use this field to point to the location’s parent location
  • glnAssignedBy (string): Indicates whether it was assigned by "GS1", "GLOBALGAP", "Internal", "Trading Partner", or "Other"
  • alternateLocationCode (string): This field provides sender and shipper to use and alternate identifier for connecting locations. This could be a URL, a UUID, or other globally unique identification scheme. The important thing is that it is unique per location and is shared between shipper and receiver. For example, this could be a GS1 Digital Link or Google Place ID
  • phoneNumber (string)*: Phone number including country code with format: +1.999.999.999 *This field is required if address is used to identify location
  • isPrimaryLocation (boolean): This indicates that the location is the primary headquarter location for the organization
  • isCoveredByGdst (boolean): Indicates that this location is covered by the Global Dialogue on Seafood Traceability requirements

Sample Payload​

{
    "locationMasterList": [
        {
            "dataProviderVendorId": "DPV001",
            "dataProviderVendorName": "Fresh Produce Inc.",
            "locationName": "Central Distribution Center",
            "locationCode": "CDC001",
            "businessUnit": "01",
            "market": "North",
            "region": "03",
            "locationType": "Internal",
            "parentLocationId": "HQ001",
            "gln": "1234567890123",
            "glnAssignedBy": "GS1",
            "duns": "123456789",
            "alternateLocationCode": "CDC-ALT",
            "phoneNumber": "+1-800-555-0199",
            "isPrimaryLocation": true,
            "isCoveredByGdst": false,
            "address": {
                "streetAddress1": "123 Main St",
                "streetAddress2": "Suite 100",
                "city": "Springfield",
                "state": "IL",
                "postalCode": "62701",
                "country": "US"
            },
            "geoLocation": {
                "gpsCoordinates": [
                    "86.271142",
                    "-79.593557"
                ],
                "geoFence": [
                    [
                        "40.28",
                        "-84.15"
                    ],
                    [
                        "40.29",
                        "-84.14"
                    ],
                    [
                        "40.27",
                        "-84.14"
                    ]
                ]
            }
        }
    ]
}

Response​

Location data ingested successfully

success